COMMENT ⊗   VALID 00003 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	25 March 1973		XEROX Program Description	          LES
C00005 00003	FEATURES
C00013 ENDMK
C⊗;
25 March 1973		XEROX Program Description	          LES

XEROX may be used to print one or more copies of naked text  (without
line  numbers, page  numbers or other adornments).  Alternatively, it
may be made to generate any of three kinds of page numbers and  other
identification data.

OPERATION

XEROX can be made to spool one or more copies of a given file  with a
monitor command of the form
.XE[ROX] <source file> [<copies>] [#] [<dest. file>] [%<format cmnd.>]
where the things enclosed in brackets are optional and the  arguments
are separated by spaces.   Files are implicitly on the disc.

If <copies> is omitted or "0" and no destination file is  given,  one
copy  will  be spooled.  A larger integer will cause that many copies
to be printed.

If the "#" is present, the output will contain source line numbers.

If a <destination file> is given, then the output goes to that  file,
which  is  then  spooled  and retained.  If the destination file name
begins with a digit and the "#" feature is not used, then the  number
of <copies> must be given explicitly.

If  no  <destination file> is given, then a temporary file is created
in [SPL,SYS] of the form <source file name>.XXd, where d is a  digit.
This file is deleted automatically after listing.

The  <format  command>, preceded by "%", may appear either at the end
of the monitor command line or in the  text  and  is  interpreted  as
described below.


EXAMPLES

.XER FOO		[Prints one copy of FOO]

.XER FOO 2 #		[Prints two copies, including source page and
			     line numbers]

.XER FOO %,2		[Prints a copy double spaced]

.XER FOO BAZ		[Copies FOO into BAZ (with specified format
			     changes), but doesn't print it]

FEATURES

XEROX automatically inserts a blank page  at  the  beginning  of  the
output,  so  that  the  first  page  of the document will face upward
relative to the paper fold.

XEROX  knows that you don't want blank lines at the top of a page and
so deletes them.  You can fool it by putting one or  more  spaces  in
the top line.


FORMAT COMMANDS

XEROX  looks for format commands beginning with "%" at the end of the
monitor command and in the top line of each page in the source  file.
If no such command is found, the text will be printed naked.

By using text commands, you can select double or mutiple line spacing
and add an identification line to the top or bottom of each page. For
example, to get sequential page numbers centered at the top  of  each
page, put
    %TOP,,,,1
at the end of the monitor command line or at the  top  of  page  one.
Alternatively, to get double spacing with no page numbers, use
    %,2

More generally, the format command has the form
    %<location>,<spacing>,<title>,<section>,<page>
where
    <location> → T[OP] | B[OTTOM] | <null>
    <spacing>  → <integer from 1 to 9> | <null>
    <title>    → <any string not containing ",">
    <section>  → <any string not containing ",">
    <page>     → <integer> | <string>-<integer> | i
Interpretation proceeds from left to right and halts  whenever  there
is nothing left.  Thus it is possible to change control parameters to
the left of some point while leaving those to the right unchanged.

The <location> specifies where  the  identification  line  (ID)  will
appear.  If it is null, then there is no ID and pages will contain up
to 54 lines.  If it is BOTTOM, then an ID line  will  appear  at  the
bottom  of  each page, which will contain up to 52 lines.  Similarly,
if it is TOP, the ID will appear there.  (Actually,  just  the  first
letter  is examined and interpreted as "B" or not-"B", upper or lower
case.

<spacing> specifies how many spaces between lines.  If it is null  or
a non-digit, you get single-spacing.

The <title>, if given, will appear at the left end of the ID line and
the <section>, if non-null, will appear in the middle of each ID line
and   be   updated   to   the   current  section  name  (see  SECTION
IDENTIFICATION, below).

The ID, if called for, always includes a page number.  If the <title>
and  <section>  are  null,  then  the  page  number will be centered.
Otherwise, it appears at the right end of the ID line.  Any of  three
kinds of page number may be selected, as follows.
    1. If <page> is an integer, then sequential page numbers will  be
        used,  beginning  with  the given value.  This is the default
        option, with the initial page numbered "1".
    2.   If  <page>  is  of  the  form "<string>-<integer>" then page
        numbers will take this form and the <string> will be  updated
        to the current section identification (see below).
    3.  If <page> is "i" then roman numerals will be  used  up  to  a
        maximum of "xx".

EXAMPLES

If the top line on the first page is just "%T,3", then you get triple
spacing,  with  pages numbered sequentially at the top center of each
page.

The  command  "%,2" produces double spacing without page numbers.  To
get roman numerals at the bottom with single spacing, use "%B,1,,,i".

The command
    %T,1,SAILON-70,Balogna,1-1
will produce single-spaced output with the following ID at the top of
each page
    SAILON-70              Balogna               1-<sequence number>


SECTION IDENTIFICATION

XEROX has rather fixed ideas about what  the  beginning  of  a  major
section looks like, namely:
   1) it must begin at the top of a source page (following any
   text command), and either
   2) the initial string up  to  the  first  SPACE  or  TAB  must
   contain  at least one "." (possibly at the end) and the second
   line of the page must be blank, or
   3) the first word of the page must be "APPENDIX".
If   these   conditions   are  met  and  page  numbers  of  the  form
<string>-<integer> are being used, then the <string> is  set  to  the
section or appendix identifier.  Similarly, the current <section>, if
non-null, is changed to the name of the new section or appendix.

For example, if the following lines appeared at the top of some page,
1.2  Chicken Fat

then the identification line on this page would be
....		Chicken Fat                     1.2-1
Alternatively,  if  the  source  line  were indented, it would not be
recognized as the beginning of a major section.   You  can  use  this
feature to control which sections initiate new page number sequences.

Similarly, the lines
                             Appendix A

                       Fricasseed Sweetbreads

would produce the heading
    ....		Fricasseed Sweetbreads		  A-1